home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / uucp / wcnews_1_0_30.lha / man / bencode.man < prev    next >
Text File  |  1994-01-04  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. BENCODE(1)                                             BENCODE(1)
  5.  
  6.  
  7. ›1mNAME›22m
  8.        bencode,  bdecode  -  encode  a binary file into printable
  9.        ASCII; decode it back into binary.
  10.  
  11. ›1mSYNOPSIS›22m
  12.        ›1mbencode›22m ›1m[source]›22m
  13.        ›1mbdecode›22m ›1m[source]›22m
  14.  
  15. ›1mDESCRIPTION›22m
  16.        ›4mBencode›24m is used to a encode a binary file  into  printable
  17.        ASCII,  and ›4mbdecode›24m is used to decode an encoded file back
  18.        into binary.  These functions are typically used to  pack­
  19.        age a binary file for mailing.
  20.  
  21.        ›4mBencode›24m  takes the named source file (the default is stan­
  22.        dard input) and produces an encoded version on  the  stan­
  23.        dard  output.  The encoding uses only the ASCII characters
  24.        ``A'' - ``Z'', ``a'' - ``z'', ``0'' -  ``9'',  ``+'',  and
  25.        ``­''.   The  ASCII  characters  blank, newline, and ``/''
  26.        also appear in the encoded  file,  but  do  not  represent
  27.        encoded  bits.  The encoded file is terminated with a byte
  28.        count and cyclic redundancy check for detecting  corrupted
  29.        files.
  30.  
  31.        ›4mBdecode›24m  reads  a  file encoded by bencode (the default is
  32.        standard input), strips off any leading and trailing lines
  33.        added  by mailers, and writes the decoded version to stan­
  34.        dard output.
  35.  
  36.        These functions are similar to ›4muuencode›24m and ›4muudecode,›24m  but
  37.        are  more robust because of the CRC check and because they
  38.        don't send characters like  ``^''  and  ``\'',  which  are
  39.        likely  to  get  mangled if the file should happen to pass
  40.        through a non­ASCII machine.
  41.  
  42.  
  43. ›1mSEE›22m ›1mALSO›22m
  44.        uuencode(1)
  45.  
  46. ›1mAUTHORS›22m
  47.        Ken Lalonde and Reg Quinton
  48.  
  49. ›1mBUGS›22m
  50.        The file is expanded by 35% (3 bytes become 4 plus control
  51.        information) causing it to take longer to transmit.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                           9 January 1988                        1
  65.  
  66.  
  67.